home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / danix201.zip / DANIX.DOC < prev    next >
Text File  |  1994-02-03  |  9KB  |  270 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                        The Danix Utilities, Version 2.01
  22.  
  23.                Program and Documentation Copyright 1990, 1994 by
  24.                                Daniel R. Schikore
  25.  
  26.                                      2/04/94
  27.  
  28.  
  29.                UNIX is a registered trademark of AT&T Corporation
  30.    Turbo-C and Borland-C are registered trademarks of Borland International
  31.  
  32.  
  33. INTRODUCTION
  34. ------------
  35. The Danix Utilities are a collection of UNIX-like utilities for DOS. Included
  36. in this release are 25 utilities.  The full documentation for each of the
  37. utilities included can be found using the 'man' command. Read the section on
  38. Installation to install the man pages.  For information on how to use man,
  39. type 'man man'.  A brief description of each command is contained in this file.
  40.  
  41. DISCLAIMER
  42. ----------
  43. The Danix utilities are provided without any warranty of any kind.  The author
  44. makes no claim about the suitability of these utilities for any purpose, and
  45. will not be held responsible for any damages of any kind resulting from the
  46. use of this software.
  47.  
  48. DISTRIBUTION
  49. ------------
  50. You are encouraged to distribute this collection as long as all original files
  51. are included unmodified, and fees are limited to reasonable media or connect
  52. time fees.  Basically, as long as you are providing a service by distributing
  53. shareware, and not selling this package, the permission of the author is
  54. granted.  I do ask that shareware vendors or other distributors who include the
  55. Danix utilities in a catalog or collection send a copy of the catalog or
  56. description of the collection to the author at the address below.
  57.  
  58. SHAREWARE NOTICE
  59. ----------------
  60. The Danix collection of utilities is a shareware package.  It is provided
  61. with full feature capability for you to examine and determine if it is of
  62. use to you. You are free to use the utilities for your personal use for two
  63. weeks.  If you would like to continue using them after this time, you should
  64. register.  For the registration fee of US $25 (personal use, 1 computer) or
  65. equivalent, you will receive the complete Turbo-C/Borland-C source for the
  66. utilities.  This source is for personal use only, and should not be
  67. redistributed in original or modified form.  As a registered user you will
  68. be entitled to future source releases for a small upgrade fee to cover
  69. shipping and handling.  Site registrations for 2 or more computers are
  70. available.  See the file register.doc for more information.
  71.  
  72. Any comments/suggestions can be sent to:
  73.  
  74. Dan Schikore
  75. drs@cs.purdue.edu (Internet)
  76.  
  77. 1983 Greenheath (US Mail)
  78. Florissant, MO 63033
  79.  
  80. INSTALLATION
  81. ------------
  82. To install the Danix utilities, place the executable files in a directory
  83. included in your path.  The manual pages (ending in '.1') should be placed
  84. in the directory 'c:/man/cat1'.  To change this directory or allow manual
  85. pages to be read from more than one directory, define an environment
  86. variable 'MANPATH', which is a semicolon separated list of directories to
  87. be searched, similar to the 'PATH' environment variable.
  88.  
  89. For example, the command
  90.  
  91. set MANPATH=c:/man;c:/dos
  92.  
  93. placed in the autoexec.bat file will cause 'man' to search in the
  94. subdirectories of c:/man and c:/dos for manual pages.
  95.  
  96.  
  97.  
  98. USAGE
  99. -----
  100. The Danix utilties operate much like their UNIX counterparts.  Filename
  101. arguments to the utilities may include the wildcard characters '*' and '?',
  102. where a '*' matches any sequence of characters and '?' matches any single
  103. character.  Characters after a '*' and before a '/' or '\' are ignored.
  104. For example, the command:
  105.  
  106. ls /tc/src/*/*.c
  107.  
  108. will list all files ending in .c in any of the subdirectories of /tc/src.
  109.  
  110.  
  111. OPTION AND PATH SPECIFIERS
  112. --------------------------
  113. Each of the Danix utilities checks an environment variable 'DANIX'
  114. which may place the utilities in one of two modes.  The command
  115.  
  116. set DANIX=DOS
  117.  
  118. will cause the Danix utilties to act like DOS utilities in recognizing
  119. option specifiers.  In this mode the '/' character specifies an option
  120. and the '\' character specifies a path separator.  The command
  121.  
  122. set DANIX=UNIX
  123.  
  124. causes the utilities to recognize the '-' character as an option specifier
  125. and the '/' character as a path separator.  The '-' character may also
  126. be used for options in DOS mode, since it causes no conflicts.
  127.  
  128.  
  129. COMMAND DESCRIPTIONS
  130. --------------------
  131.  
  132. CAT
  133. ---
  134. cat prints files to the standard output.  It can be used as a filter
  135. by including a minus sign '-' in the file list.
  136.  
  137. CHMOD
  138. -----
  139. chmod changes the access modes on files.  The modes which it can change
  140. are the archive bit, read-only attribute, hidden file attribute, and system
  141. file attribute.
  142.  
  143. CMP
  144. ---
  145. cmp compares two files for differences.  The comparison is on a byte for
  146. byte basis, and by default comparison stops when the first difference is
  147. found.
  148.  
  149. CP
  150. --
  151. cp copies files and/or entire directories to the same or a different disk.
  152.  
  153.  
  154.  
  155. CUT
  156. ---
  157. Used most often as a filter, cut will select parts of each line of input
  158. to be printed to standard output.  It can also take input from files or
  159. both files and standard input by including a '-' in the file list.
  160.  
  161. CWD
  162. ---
  163. cwd prints the current working directory on the current drive or the drive
  164. supplied as a parameter.
  165.  
  166. DAYTIME
  167. -------
  168. daytime simple prints the approximate time of day in non-military time.
  169.  
  170. DTREE
  171. -----
  172. dtree prints a directory tree beginning with a specified path and drive,
  173. or the current directory by default.
  174.  
  175. DU
  176. --
  177. du gives the disk usage for a directory tree by recursing through its
  178. subdirectories.  Output can be given in bytes, kilobytes, or disk blocks.
  179.  
  180. HEAD
  181. ----
  182. head prints out the first 10 lines of a text file or standard input, or
  183. both, if '-' is in the file list.  The number of lines printed can be
  184. changed with a parameter.
  185.  
  186. FGREP
  187. -----
  188. fgrep searches text files for one or more strings.  It can perform case-
  189. sensitive or case-insensitive searches, and will output either all matching
  190. lines or all lines which do not match.
  191.  
  192. LS
  193. --
  194. list the contents of a directory.  By default, it prints the current
  195. directory contents, excluding hidden files.  Many options allow for
  196. many different forms of listings.
  197.  
  198. MAN
  199. ---
  200. man is a manual reader to display documentation files.  manual "pages" can
  201. be added by creating a file with any word processor, and placing the file in
  202. a subdirectory of c:\man\cat or any directory specified in MANPATH.  For
  203. more information, install the manual pages for Danix as specified earlier,
  204. and type 'man man'.
  205.  
  206. MV
  207. --
  208. mv will move files and/or directories.  They may be moved within the same
  209. directory (simple renaming), to another directory on the same disk, or to
  210. another disk.
  211.  
  212.  
  213.  
  214. PASTE
  215. -----
  216. paste joins files horizontally.  It prints the first line of the first
  217. file argument, followed by a tab, and the first line of the second file
  218. argument, etc. until the file list has been exhausted.  Standard input
  219. can be used as one of the files by including a '-' in the file list.
  220.  
  221. PRINTENV
  222. --------
  223. print the environment, or if given a variable, print only that environment
  224. variable.
  225.  
  226. PTIME
  227. -----
  228. ptime gives the execution time of a command.  It passes all arguments to
  229. the command interpreter, and then displays a message telling how long the
  230. program took to execute.  Times may vary from computer to computer and
  231. are only approximate because the command interpreter must search for the
  232. file, if necessary.
  233.  
  234. RM
  235. --
  236. rm removes files and/or directories.  It can forcefully remove files without
  237. question and without regard for read-only status, or it can query the user
  238. to delete each file.
  239.  
  240. TAIL
  241. ----
  242. prints out the last ten lines of its file arguments, and standard input,
  243. if '-' is in the file list.  Number of lines printed is controllable.
  244.  
  245. TEE
  246. ---
  247. tee copies the standard input to one or more files while also passing it
  248. through to standard output.  This can be used to save intermediate output
  249. in a chained command.
  250.  
  251. TOUCH
  252. -----
  253. updates the time stamp on a file, or creates the file if it does no